(C) 1996 AROS - The Amiga Replacement OS


NAME
#include <proto/utility.h>
ULONG FilterTagItems()
SYNOPSIS
struct TagItem * tagList
Tag * filterArray
ULONG logic

LOCATION
In UtilityBase at offset 16
FUNCTION
Scans a tag list and removes tag items from the list depending upon whether the tag's Tag value is found in an array of tag values.

If 'logic' is TAGFILTER_AND, then all the tags that are NOT in the array filterArray will be removed from the tagList.

If 'logic' is TAGFILTER_NOT, then all the tags that ARE in the array filterArray will be removed from the tagList.

Tags are removed by setting their ti_Tag value to TAG_IGNORE.

INPUTS
tagList
A TagList to filter items from.
filterArray
An array (as described by TagInArray()) to determine which tag items are to be removed.
logic
Whether the tags in filterArray are to be included or excluded from the tag list.
RESULT
The number of valid items left in the resulting filtered list.

NOTES
EXAMPLE
BUGS
SEE ALSO
TagInArray()
INTERNALS
HISTORY
27.01.1997 ldp
Polish
08.01.1997 iaint
A few more utility.lib functions